Turn into a refenty

svn path=/trunk/; revision=21932

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8052f314f68acbb6f29190b2f8e2f139b48232e5..82cae93173886f3ff0c231a078ee0fac81bc9eed 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2008-12-26  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/drawing-model.sgml: Turn into a refentry to fit better in 
+       the overall formatting.
+
 2008-12-25  Matthias Clasen <mclasen@redhat.com>
 
        * gdk/gdk-docs.sgml: Add a "Since 2.16" index

diff --git a/docs/reference/gtk/drawing-model.xml b/docs/reference/gtk/drawing-model.xml
index 18f0ee7ae9e5f2b91d6b616f14e18572130c8623..7c0d20ea6a9536c0e26d2e24a540ca291abd50f3 100644 (file)
--- a/docs/reference/gtk/drawing-model.xml
+++ b/docs/reference/gtk/drawing-model.xml
@@ -2,22 +2,34 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 ]>
-<chapter id="chap-drawing-model">
-  <title>The GTK+ Drawing Model</title>
-
-  <para>
-    This chapter describes the GTK+ drawing model in detail.  If you
-    are interested in the procedure which GTK+ follows to draw its
-    widgets and windows, you should read this chapter; this will be
-    useful to know if you decide to implement your own widgets.  This
-    chapter will also clarify the reasons behind the ways certain
-    things are done in GTK+; for example, why you cannot change the
-    background color of all widgets with the same method.
-  </para>
-
-  <section id="drawing-overview">
+<refentry id="chap-drawing-model">
+<refmeta>
+<refentrytitle>The GTK+ Drawing Model</refentrytitle>
+<manvolnum>3</manvolnum>
+<refmiscinfo>GTK Library</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+<refname>The GTK+ Drawing Model</refname>
+<refpurpose>
+    The GTK+ drawing model in detail
+</refpurpose>
+</refnamediv>
+
+
+  <refsect1 id="drawing-overview">
     <title>Overview of the drawing model</title>
 
+    <para>
+      This chapter describes the GTK+ drawing model in detail.  If you
+      are interested in the procedure which GTK+ follows to draw its
+      widgets and windows, you should read this chapter; this will be
+      useful to know if you decide to implement your own widgets.  This
+      chapter will also clarify the reasons behind the ways certain
+      things are done in GTK+; for example, why you cannot change the
+      background color of all widgets with the same method.
+    </para>
+
     <para>
       Programs that run in a windowing system generally create
       rectangular regions in the screen called
@@ -66,7 +78,7 @@
       of the resources they use from the windowing system.
     </para>
 
-    <section id="window-no-window-widgets">
+    <refsect2 id="window-no-window-widgets">
       <title>Window and no-window widgets</title>
 
       <para>
@@ -159,9 +171,9 @@
        well.  Widgets may have more than one window if they want to
        define different regions for capturing events.
       </para>
-    </section>
+    </refsect2>
 
-    <section id="hierarchical-drawing">
+    <refsect2 id="hierarchical-drawing">
       <title>Hierarchical drawing</title>
 
       <para>
@@ -288,9 +300,9 @@
        itself in turn, GTK+ uses a double-buffering mechanism.  The following
        sections describe this mechanism in detail.
       </para>
-    </section>
+    </refsect2>
 
-    <section id="notes-on-drawing-no-window-widgets">
+    <refsect2 id="notes-on-drawing-no-window-widgets">
       <title>Notes on drawing no-window widgets</title>
 
       <para>
@@ -315,9 +327,9 @@
        then your drawing origin should be at (5,&nbsp;6), not at
        (0,&nbsp;0).
       </para>
-    </section>
+    </refsect2>
 
-    <section id="include-inferiors">
+    <refsect2 id="include-inferiors">
       <title>Drawing over child windows</title>
 
       <para>
@@ -331,10 +343,10 @@
        linkend="gdk-Graphics-Contexts">GdkGC</link> which you use for
        drawing.
       </para>
-    </section>
-  </section>
+    </refsect2>
+  </refsect1>
 
-  <section id="double-buffering">
+  <refsect1 id="double-buffering">
     <title>Double buffering</title>
 
     <para>
@@ -392,7 +404,7 @@
       the buffer onto the on-screen window, and frees the buffer.
     </para>
 
-    <section id="automatic-double-buffering">
+    <refsect2 id="automatic-double-buffering">
       <title>Automatic double buffering</title>
 
       <para>
@@ -459,10 +471,10 @@ my_widget_init (MyWidget *widget)
        <function>gdk_window_end_paint()</function> by hand to use
        temporary drawing buffers.
       </para>
-    </section>
-  </section>
+    </refsect2>
+  </refsect1>
 
-  <section id="app-paintable-widgets">
+  <refsect1 id="app-paintable-widgets">
     <title>App-paintable widgets</title>
 
     <para>
@@ -563,29 +575,12 @@ gtk_window_expose (GtkWidget      *widget,
        <emphasis>is</emphasis> intended to be drawn on.
       </para>
     </formalpara>
-  </section>
-
-  <section>
-    <title>TODO</title>
-
-    <itemizedlist>
-      <listitem>
-       <para>
-         APP_PAINTABLE: link the flag's documentation to this document.
-       </para>
-      </listitem>
-      <listitem>
-       <para>
-         DOUBLE_BUFFERED: link the flag's documentation to this document.
-       </para>
-      </listitem>
-    </itemizedlist>
-  </section>
-</chapter>
+  </refsect1>
+</refentry>
 
 <!--
 Local variables:
 mode: xml
-sgml-parent-document: ("gtk-docs.sgml" "book" "part" "chapter")
+sgml-parent-document: ("gtk-docs.sgml" "book" "part" "refentry")
 End:
 -->